<html lang="en" xml:lang="en"><head>
<META http-equiv="Content-Type" content="text/html">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"><META name="description" content="The Group Filter widget allows you to apply a filter on the map
based on one or more layers in the map."><meta name="content-language" content="en"><link href="rsrc/htmlhelp.css" rel="stylesheet" type="text/css"><title>Web AppBuilder for ArcGIS | Help - 
Group Filter
widget</title>
                <script type="text/javascript" language="JavaScript">
                    var pathL  = self.location.pathname.split ("/");
                    var fname = pathL[pathL.length-1];
                    var i = fname.lastIndexOf (".htm");
                    if (i>=0) {
                    fname = fname.substring (0, i)
                    } else {
                    //??
                    }
                    if (self.location.hash) {
				    		      fname = fname + self.location.hash;
						        }
                    self.location.replace ("../index.html#//" + fname);
                </script>
                </head><!--Publication GUID: [GUID-E7D1C130-8F87-4109-8D61-E73A46083F52]--><!--Topic GUID: [GUID-03D7389D-7046-425B-BE4E-991EA9FB7260]--><body><div id="content"><div class="header"><h1>
Group Filter
widget</h1><div id="breadcrumb"></div></div>
<p id="GUID-B7B19DF1-1110-46CE-B537-8A750AA7F0C9">The Group Filter widget allows you to apply a filter on the map
based on one or more layers in the map. A set of layers are grouped
into a logical filter set. Each set can have a predefined value to
facilitate user interaction. This widget has two modes: normal
mode, which allows building complex filters during runtime, and
simple mode, which only allows one filter criteria to be applied.
</p><div class="section1" id="GUID-B968C734-C442-4698-A6EE-5FFD3848984E" purpose="section1"><h2>Configuring the Group Filter widget

</h2><p id="GUID-C1089B8A-732C-41F8-ADCC-41AAEE86AACD">The Group Filter
widget can be set to open automatically when an app starts. To do
so, click the yellow dot on the widget to turn it dark green.</p><p id="GUID-BB3F352A-0725-4DAA-92D5-01739758F55E">The following
steps indicate how to create a filter set. Repeat these steps if
you need to define additional filter sets.</p></div>
<div class="wfsteps" purpose="wfsteps"><h4></h4><div class="steps" id="GUID-C83A79EC-AA43-484F-B080-77858BB70F1E"><div class="step_title">Steps:</div><ol><li purpose="step" id="GUID-F5A60809-F36A-46C3-9814-FB208243F707">
<span purpose="cmd" id="GUID-DA5E5A20-25AA-46DF-B940-90EBC850735E">
 Hover over the  widget and click the small edit icon <img purpose="img" placement="inline" alt="Edit" title="Edit" src="03w3/GUID-31D329BD-BC73-4BBE-AE1D-3A1261BF912A-web.png">. The configuration window for this widget opens. </span>
</li><li purpose="step" id="ESRI_STEP_0CF0A541EFCD4EB8BADB970D57173B37"><span purpose="cmd" id="GUID-C3B41088-C9F5-44EC-8594-296C205E791D">Optionally click <span class="uicontrol">change widget icon</span>  if you want to replace the default icon for this widget. </span><div class="info" purpose="info">A file explorer window opens, allowing you to choose a local image file to use as the widget icon.</div></li>
<li purpose="step" id="GUID-DE8E66CA-B3E5-4EA3-8817-756D83032F49">
<span purpose="cmd" id="GUID-2C195F09-B7B4-4E65-8061-C6CE5D0C81B0">
 The configuration should display one group that's ready to modify.
</span>
</li><li purpose="step" id="ESRI_STEP_BB786C1E35974469922C198A1E3E41E2"><span purpose="cmd" id="GUID-775C8B20-D79C-4812-A444-5F61B8CAB8F5"> Define a <span class="uicontrol">Filter Set Name</span>. This is the name of the filter that the user will select from. Optionally, you can give a description to guide users on what this group will filter.</span></li><li purpose="step" id="ESRI_STEP_03E4E5F17EC741AAA8AB4FC210B22F45"><span purpose="cmd" id="GUID-20C289E7-2D52-4E14-8B86-CA39B4842F5C"><span class="uicontrol"> Preset Operator</span> and <span class="uicontrol">Preset Value</span> are both optional. They allow you to have a predefined value for this filter so that during runtime, the user does not have to supply the criteria. For <span class="uicontrol">Preset Value</span>, you have the option to type in a value or click the magnifying glass icon to choose a value from an existing layer.</span></li><li purpose="step" id="ESRI_STEP_A3EF01CACA3641CF8AB15BDC08E8387E"><span purpose="cmd" id="GUID-BC7F7D3D-3C6E-4940-B5C0-EA75B5C146B6">If you are going to filter on different fields in the same layer, the next optional parameter <span class="uicontrol">When a layer is listed more than once, use the following operator between fields</span> controls how to join these filters together using <span class="uicontrol">OR</span> or <span class="uicontrol">AND</span>.</span></li><li purpose="step" id="ESRI_STEP_250E224DF3644E07A25397F29A6B99E6"><span purpose="cmd" id="GUID-B622A00D-A23F-472B-A0E0-2A1F80285730"> The next area is a table of layers to group together under this filter set. By default, you should see one layer already populated with a random layer from your map. Choose the layer and the field to which you want to apply a filter. The radio button under the column <span class="uicontrol">Use Value</span> dictates whether or not you want a value drop-down list for the user to find a value. If no radio button is marked, a plain text box will be presented to the user. This radio button is optional.</span></li><li purpose="step" id="ESRI_STEP_50F6EC79A82D4CF4AF834CFDD16BF24B"><span purpose="cmd" id="GUID-CB6E131E-AE1F-44F5-BD1F-7AC1F69B0AC1"> To add another layer to this filter set, click the <span class="uicontrol">Add Layer</span> button.</span></li><li purpose="step" id="ESRI_STEP_98E513DB37E747ED9C4E673F0CF42A5B"><span purpose="cmd" id="GUID-C655D442-F401-4134-B2BF-68AD899890B3"> If you want to add another filter set, click the <span class="uicontrol">Add a New Group</span> button. This will create another filter set grouping. If needed, repeat step 3 through 7.</span></li><li purpose="step" id="ESRI_STEP_40D32D4D7A594AC0B82BC07D5E52C2A6"><span purpose="cmd" id="GUID-84C0F4FB-081B-4302-A237-B88F013A6AF8"> The next four check boxes control the way the widget behaves. </span><ul purpose="choices" id="ESRI_CHOICES_B1884053C2184B8E91430A54917EB911"><li purpose="choice" id="ESRI_CHOICE_786DB0C54E974CABA5FA0BEC91082FD9"> <span class="uicontrol">Start in Simple View</span> determines how the widget will look to end users. Checking this box will remove the operator drop-down list and the add criteria button from the interface. This will make the interface look more simplistic.</li><li purpose="choice" id="ESRI_CHOICE_E95174366F1E4FF9BC248F202CC5E43D"><span class="uicontrol">Hide Widget Options</span> determines whether to show an icon to expose additional widget settings. These settings include saving and loading defined filters, appending to an existing filter definition in the map if it exists, and persisting the filter even after the widget is closed.</li><li purpose="choice" id="ESRI_CHOICE_3BA5CD9B50FD4469B9208C76B449783E">If the web map has an existing predefined filter applied, <span class="uicontrol">Append Filter to Existing Web Map Filter Using OR or And</span> allows you to decide if you want to override this filter or append filters created in this widget to the existing web map filter. By default, this widget will override the web map filter.</li><li purpose="choice" id="ESRI_CHOICE_5C8B0CB9C3D64C9280986BD1916BFAA5"><span class="uicontrol">Zoom to</span> determines whether to zoom the map to the extent of the filtered data. By default, the map maintains its current extent.</li></ul></li>
</ol></div></div>
<div class="section1" id="ESRI_SECTION1_B6F37F2C52B44C1EAF1786ED72892E81" purpose="section1"><h2>Using the Group Filter widget

</h2></div><div class="wfsteps" purpose="wfsteps"><h4></h4><div class="steps" id="ESRI_STEPS_C1B7030B5410494A9BCC10C103BEB6DA"><div class="step_title">Steps:</div><ol><li purpose="step" id="ESRI_STEP_8F32AA3FC19F47538634D0AF9BFE69BE"><span purpose="cmd" id="GUID-92695200-2C7B-4652-8757-587B230DD76D">Clicking the Group Filter widget in your app displays a selection of predefined filter sets. Notice below the gray line divider, you see an operator and a drop-down list. This is interpreted, for example, as  filter the map and show only Abandoned Motor Vehicle complaints. Click <span class="uicontrol">Apply</span> to execute filtering the map.<div class="image" purpose="image"><table><tr><td><img class="break" src="03w3/GUID-9C68DF4A-AB42-40DC-B882-AE64ECF4A0A7-web.png" purpose="img" alt="Apply a predefined filter set" title="Apply a predefined filter set"></td></tr></table></div></span></li><div class="stepinfo" purpose="stepinfo"><div class="notes" id="GUID-BDB124D2-1B79-42E8-897F-4F9171F0C998"><div class="tip"><img class="note_img" src="rsrc/tip.png" alt="Tip" title="Tip"><span>Tip:</span></div><div class="tipbody">Depending on how you configured the layers in the widget, after the
operator drop-down list, you will either see a value drop-down list like
in this example, a plain text box for user input, or a date picker.
</div></div></div><li purpose="step" id="ESRI_STEP_1C311D624A20429895E91458F82E71AF"><span purpose="cmd" id="GUID-7CE5B432-DA07-4FD5-8F08-9F2E85703707">Clicking <span class="uicontrol">Reset</span>  will remove the filter and restore the map to the state prior to using the widget.</span></li><li purpose="step" id="ESRI_STEP_419715C827114C02A039FE01DF54507D"><span purpose="cmd" id="GUID-E6276B3B-488A-4902-A0EA-983D182C0B0F">The widget allows you to add additional filter criteria at runtime. Click the <span class="uicontrol">Add Criteria</span> button to add another clause. Notice that the two criteria are joined with a conjunction. You can choose to join them using either <span class="uicontrol">OR</span> or <span class="uicontrol">AND</span>. <div class="image" purpose="image"><table><tr><td><img class="break" src="03w3/GUID-1735D68E-95CB-4662-B9FB-F04A65E14DBD-web.png" purpose="img" alt="Add additional filter criteria" title="Add additional filter criteria"></td></tr></table></div></span></li><li purpose="step" id="ESRI_STEP_768B0C29972B447AAFCE3D978FA2D326"><span purpose="cmd" id="GUID-638D4067-210A-44AF-AF2F-8771E4C963FF">The widget has a save option to save these defined criteria settings for future use. Click the gear icon. The widget panel will switch to the options panel.<div class="image" purpose="image"><table><tr><td><img class="break" src="03w3/GUID-7605C534-9D9D-43AE-B289-54E5B73E838D-web.png" purpose="img" alt="Save option" title="Save option"></td></tr></table></div></span><div class="substeps" id="ESRI_SUBSTEPS_7A637EF75F144FA78B6FE482A82C4CC9" purpose="substeps"><ol><li purpose="substep" id="ESRI_SUBSTEP_4226C11FE7C3477E827F7090C87EA7AA"><span purpose="cmd" id="GUID-B8D6448A-BE51-4717-B8FF-6B1FB5CA59EB">Clicking <span class="uicontrol">Save</span> will save the defined criteria locally as a JSON text file.</span></li><li purpose="substep" id="ESRI_SUBSTEP_758A431403B04014AD02A88F1FC1ABB1"><span purpose="cmd" id="GUID-A5662D98-E67F-41E4-9A9B-79598F884013">Under <span class="uicontrol">Upload a Saved File</span>, you can load a previously saved file to load back all the criteria defined in the file.</span></li><li purpose="substep" id="ESRI_SUBSTEP_FD29BF1309D44DEDBEF43B7618A7CEB9"><span purpose="cmd" id="GUID-7DF055B5-70CD-4046-AC81-243AC0E93785">If you need to use the filtered map in other widgets, you can
enable it here to persist the filter after this widget is closed.
By default, closing the widget will revert all filters to the map's
initial state.
</span></li></ol></div></li></ol></div></div><div class="footer"> Copyright © 1995-2016 Esri. All rights reserved. </div></div></body></html>